Release 10.1A: OpenEdge Deployment:
WebClient Applications

Using the LOAD–IMAGE() method

This is the syntax of the LOAD–IMAGE() method, as specified in OpenEdge Development: Progress 4GL Reference :

Syntax

LOAD-IMAGE ( filename   [ ,     x-offset ,     y-offset ,     width ,     height   ] )

The LOAD–IMAGE() method applies to images and buttons. LOAD–IMAGE() reads the image contained in filename. LOAD–IMAGE() recognizes PROPATH entries consisting of URLs. If LOAD–IMAGE() finds an image in the directory specified by a URL, LOAD–IMAGE() downloads the image from the Web server and loads it into local memory directly, bypassing the end user’s disk.

If the filename argument is fully qualified (whether URL or local pathname), LOAD–IMAGE() loads the image file directly, without searching directories or URLs in PROPATH.

If LOAD–IMAGE() cannot load the specified image file, it returns an error indicating the reason for the failure.

Note: You can also download images over the Web by using the LOAD–IMAGE–DOWN(), LOAD–IMAGE–UP(), LOAD–IMAGE–INSENSITIVE(), and LOAD–ICON() methods. This feature is less useful, however, because these methods are generally called for transient graphical-interface events requiring an immediate response, which a Web download might not be able to satisfy.